Overview Node-RED 自定义模块

本参考资料提供了 OV20i Node-RED 环境中所有 Overview 自定义节点的技术规格。这些专用节点扩展了标准 Node-RED 功能，用于视觉检测工作流。

Overview 自定义节点架构

OV20i 包含预装的专为机器视觉应用设计的自定义节点。这些节点为检测操作提供了标准化接口，并确保与工业自动化系统的兼容性。

节点类别：

• 检测逻辑节点 - 处理和评估检测结果
• 数据处理节点 - 格式化和转换检测数据
• I/O 控制节点 - 与硬件输入输出接口
• 系统控制节点 - 管理相机功能和状态

All Block Outputs 节点

目的与功能

“All Block Outputs” 模块是统一流水线系统中的关键组件，负责在每次相机捕获后输出数据。它汇总并处理所有 AI 模块数据，确保输出内容全面且详尽。

功能

该模块以 JSON 对象形式输出数据。数据包含来自各种 AI 过程的信息，如检测、对齐、分类和分割。每次捕获的输出结构严谨，提供对检测过程的有价值洞察。

数据字段

检测数据

• Inspection ID： 一个递增的 16 位整数，用于标识每次检测
• Inspection Time： 以 ISO 8601 格式表示的检测捕获时间戳
• Image URL： 捕获图像的 HTTP URL（jpg 格式）

对齐数据

• Success： 指示零件是否成功对齐
• Center Location X： 对齐零件中心的 x 坐标
• Center Location Y： 对齐零件中心的 y 坐标
• Confidence： 对齐的置信度（0-1）
• Matched Angle： 相对于模板匹配的角度

分类数据

预测信息：

• ROI ID： 预测的感兴趣区域（ROI）ID
• ROI Name： 预测的 ROI 名称
• Confidence： 预测类别的置信度（0-1）
• Predicted Class： 预测类别名称

分割数据

• Confidence Score Threshold： 用于处理分割模型输出的阈值（0-1）

斑点（Blobs）：

• Center X： 斑点中心的 x 坐标
• Center Y： 斑点中心的 y 坐标
• Pixel Count： 斑点的像素总数（面积）
• Major Axis Length： 主轴长度（像素）
• Minor Axis Length： 次轴长度（像素）
• ROI ID： 预测的 ROI ID
• ROI Name： 预测的 ROI 名称
• Predicted Class： 斑点的预测类别名称

类别（Classes）：

• Predicted Class： 类别名称
• Number of Blobs： 类别中斑点数量
• Pixel Count： 类别中所有斑点的像素总数（面积）

Classification Block Logic 节点

目的与功能

“Classification Block Logic” 节点用于设置和评估分类模块输出的规则。该节点输出布尔值（true/false），取决于所有规则是否全部通过或任一规则是否通过。

功能

默认情况下，如果未设置任何规则，当所有检测结果均为“pass”类别时，输出为 true；若有任何类别非“pass”，输出为 false。该节点支持通过规则设置进行自定义，允许对分类结果应用更具体的判定标准。

主要特性

• 支持对分类模块输出设置具体规则
• 基于规则评估输出布尔值（true/false）
• 默认行为确保所有检测均为“pass”时输出 true，任一不为“pass”时输出 false
• 可配置置信度阈值，实现更精准的规则设定
• 无需立即连接其他组件，便于未来灵活集成

使用场景

• 通过验证所有检测输出均符合“pass”标准，确保质量控制一致性
• 通过自定义规则设置，适应多样化检测需求
• 为自动化决策流程提供清晰的通过/不通过输出

Format Data for PLC 节点

目的与功能

“PLC Format Node” 用于将模块输出格式化为默认的 PLC 格式。通过遵循特定的字节序要求，确保与各种 PLC（可编程逻辑控制器）系统的兼容性。

功能

该节点将模块输出数据格式化，转换为目标 PLC 系统所需的字节序。主要支持两种字节序：

• 小端序（Little-endian）： 通常用于 Allen-Bradley PLC
• 大端序（Big-endian）： 通常用于 Siemens PLC

通过正确格式化数据，该节点确保与相应 PLC 系统的无缝集成和通信，实现准确可靠的数据处理。

主要特性

• 将模块输出格式化为默认 PLC 格式
• 支持 Allen-Bradley PLC 的小端序
• 支持 Siemens PLC 的大端序
• 确保与多种 PLC 系统的兼容性和可靠数据交换
• 提升自动化控制流程的效率和准确性

使用场景

• 将 AI 和自动化系统的数据输出集成至 Allen-Bradley 和 Siemens PLC
• 确保字节序转换正确，实现 PLC 的准确数据解析
• 优化工业自动化中模块输出与 PLC 之间的通信

Final Pass/Fail Output 节点

目的与功能

“Final Pass/Fail Output Node” 用于设置并存储检测的最终通过/不通过状态。该节点确保检测结果被清晰定义、传达并以布尔值形式归档。

功能

该节点处理检测结果，输出表示整体状态的布尔值：

• True： 表示检测通过
• False： 表示检测未通过

节点输出通过/不通过状态，并存储结果以备后续参考和分析。通过提供明确且记录的通过/不通过输出，该节点简化了自动检测系统的决策过程，同时确保所有结果均被归档以满足可追溯性和质量控制需求。

主要特性

• 设置并存储检测的最终通过/不通过状态
• 输出布尔值：false 表示不通过，true 表示通过
• 确保检测结果的清晰且无歧义的传达
• 归档检测结果，便于未来参考和分析
• 提升自动化质量控制流程的效率
• 与检测系统中的其他节点和组件无缝集成

使用场景

• 确定并存储制造过程中的质量控制检测结果
• 基于检测结果自动化决策流程
• 为下游系统和流程提供简明的通过/不通过输出
• 通过归档检测结果确保可追溯性和质量控制

Save to Library 节点

目的与功能

“Capture Save Decision Node” 用于决定是否将捕获的图像保存到库中。该节点输出布尔值以指示保存决策。

功能

该节点处理捕获数据，输出布尔值表示是否应保存该捕获：

• True： 表示应保存到库中
• False： 表示不保存

通过明确的保存/不保存决策，该节点有助于高效管理存储资源，确保仅相关捕获被归档以备后续使用。

主要特性

• 决定是否将捕获保存至库
• 输出布尔值：false 表示不保存，true 表示保存
• 确保存储资源的高效管理
• 有助于归档相关捕获以备未来参考和分析
• 与捕获和存储系统中的其他节点和组件无缝集成

使用场景

• 在自动检测过程中决定是否保存捕获图像
• 通过仅保存相关捕获管理存储资源
• 为下游系统和流程提供简明的保存/不保存输出
• 确保重要捕获被归档以满足可追溯性和质量控制

Capture Metadata 节点

目的与功能

“Metadata Assignment Node” 用于设置与每次捕获相关联的元数据。元数据可包含序列号、零件号或其他相关信息。分配的元数据将与捕获数据一起显示在库中。

功能

该节点允许为每次捕获添加元数据。元数据结构为一个对象，键为字符串，值可以是字符串或数字。此举确保每次捕获附带重要的上下文信息，便于未来识别和引用。

主要特性

• 为每次捕获分配元数据
• 元数据可包含序列号、零件号或其他相关信息
• 结构为键为字符串，值为字符串或数字的对象
• 确保库中的捕获附带上下文信息
• 增强捕获数据的可追溯性和识别性
• 仅当存在 Pass\Fail 节点时，捕获元数据才会存储到库中

使用场景

• 为捕获图像添加序列号、零件号或其他标识符
• 为存储在库中的捕获提供额外的上下文和信息
• 便于在分析和复查时识别和引用捕获
• 与捕获和存储系统中的其他节点和组件集成元数据

Output 节点

目的与功能

“Digital Output Node” 用于控制 OV20i M12 连接器上的输出引脚。节点根据布尔值控制引脚的开关状态。

功能

• True： 使引脚开启（ON）
• False： 使引脚关闭（OFF）

数字输出节点操作简单，无可编辑属性，确保性能稳定可靠。

引脚配置

引脚号	线色	描述
10	紫色	输出 1
11	灰/粉色	输出 2

备注

数字输出本身不支持脉冲配置，需添加触发器以生成脉冲。

主要特性

• 控制 OV20i M12 连接器上的输出引脚
• 通过布尔值确定引脚状态（开/关）
• 无可编辑属性，确保简洁可靠

使用场景

• 通过开启或关闭特定输出引脚实现自动化控制
• 与其他控制系统集成，实现协调操作
• 为 OV20i 提供简单的数字输出控制接口

Input 节点

目的与功能

输入节点读取 OV20i M12 连接器上的数字输入状态，允许外部信号触发 Node-RED 流程中的动作。

主要特性

• 实时输入监控
• 外部设备集成
• 硬件信号检测

Onboard Status LED 节点

目的与功能

“Onboard Status LED Node” 用于控制 OV20i 顶部的板载状态 LED。该 LED 可显示多种颜色，包括黄色、橙色和绿色。

功能

• True： 点亮 LED
• False： 熄灭 LED

该节点提供简洁接口，便于控制状态 LED，轻松指示设备的不同状态或状态。

LED 颜色

• 黄色
• 橙色
• 绿色

主要特性

• 控制 OV20i 板载状态 LED
• 通过布尔值控制 LED 状态（开/关）
• 支持多种 LED 颜色：黄色、橙色和绿色
• 提供设备状态的可视指示

使用场景

• 指示 OV20i 的运行状态
• 为各种系统状态或警报提供视觉反馈
• 通过清晰可见的状态指示增强用户界面体验